CCCCCCCCCCCC
CCCCCCCCCCCC
CCCC
CCCC   ooooooo
CCCC   oo   oo  nnn                                    
CCCC   oo   oo  n n t r i b u t e d  Library for the Agilent ChemStation
CCCC   oo   oo  n n
CCCC   ooooooo
CCCC
CCCCCCCCCCCC
CCCCCCCCCCCC


   

Date: 27-Jan-05
LC Macro Contribution #17
Contribution 'Changing Naming convention for exported XML result files'



Revision History
----------------

  1. A.01  Original Version for ChemStation  27-Jan-05
  2. A.02  Updated Version for ChemStation B.04.01   22-Sep-08
 

Contribution Purpose
--------------------
    

These user contributed macros allow to modify the name of the result XML file
to be exported to a remote directory. These macros can be only used in 
conjunction with the XML connectivity, documented in the XML Connectivity Guide
(see manual section on the ChemStation CD-ROM).



NOTES:	- This is a user contributed macro. It is not officially
          supported by Agilent Technologies.
	- It is not fully tested so some unknown errors can occure. 



Contribution Structure
----------------------

This macro is a set of files, containing...

  	  	- XML_DATE_TIME_LIMSID.mac
		- XML_LIMSID_DATE_TIME.mac
	    	- readme.txt 




Prerequisites
-------------

- MS operating system as required by the revision of the 
  ChemStation in use 
- The ChemStation software, Rev. B.04.01 or higher



Installation
------------


	* Copy only ONE of the following macros to ChemStation's
          executable directory as follows:

              C:\Chem32\CORE\XML_DATE_TIME_LIMSID.mac
                                
				OR

              C:\chem32\CORE\XML_LIMSID_DATE_TIME.mac

	* Modify C:\Chem32\CORE\USER.MAC to contain the following line
              Macro "macro name of your choice from above"
        



Use
---


        If no user.mac file is present, please remember, that the macro
        need to loaded every time the ChemStation has been restarted.

	* Load the macro into the ChemStation using the command...

		Macro XML_DATE_TIME_LIMSID.mac

                               OR

		Macro XML_LIMSID_DATE_TIME.mac
	
	 
        If the macro is called from the user.mac file, the macro is 
        present and will be executed.
	


Operation Overview
------------------

The macro is changing the name of the resulting XML file for remote directories,
in case the XML functionality is enabled. Remeber, that the name of the results 
file in the raw datafile directory is always the same: result.xml. 

Default:
--------
The XML file copied to the remote directory under a different name is constructed as:

InstrumentName_SampleName_YYMMDDHHmmSS.xml

where the time included is the time of creating the file.
All the spaces in the instrument or sample’s name are replaced with underscore “_”

Macro solution:
----------------
Using Macro XML_DATE_TIME_LIMSD.mac the XML file name copied to the remote directory 
is constructed as:

XML_DATE_TIME_LIMSD.xml

Using Macro XML__LIMSD_DATE_TIME.mac the XML file name copied to the remote directory 
is constructed as:

XML__LIMSD_DATE_TIME.xml